home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / mis_cnvt / ascii2db / convdb.doc next >
Text File  |  1990-01-11  |  7KB  |  156 lines
  1.                                      'Easy Data'
  2.                               Ascii to dBASE Converter
  3.                                  Copyright (c) 1990
  4.                                          by
  5.                                    John J. Caputo
  6.  
  7.  
  8. Easy Data is a fast and simple way of converting ascii files into
  9. dBASE compatible files.  All you do is describe your ascii file to
  10. Easy Data and it does the rest.  It can even create a Clipper
  11. format(.NTX) index file to save you the time in Clipper.  Your file
  12. descriptions are saved in mask files which can be used again later.
  13.  
  14. Files:
  15.        CONVDB.EXE         Easy Data main program
  16.        CONVDB.DOC         This file
  17.        DEFAULT.ADB        Default ascii to dbase mask file.
  18.        DEMO.ADB           Demo mask file.
  19.        DEMO.TXT           Demo non field delimited ascii file for
  20.                           conversion.
  21.        DEMO2.ADB          Demo mask file 2.
  22.        DEMO2.TXT          Demo delimited ascii file for conversion.
  23.  
  24. Specifications:
  25.  
  26.        - Input ASCII files.
  27.              -with or without field delimiters.
  28.              -with or without record delimiters.
  29.        - Output dBASE compatible Data and Index files.
  30.              -up to 36 fields.
  31.              -up to 255 characters/field.
  32.              -field types  C,N,D or L
  33.        - Works in interactive mode or from batch files.
  34.  
  35.  
  36. Usage:
  37.        CONVDB [file_name]
  38.  
  39.              [file_name] (optional)  this invokes the batch mode.  The
  40.              mask file_name will be loaded and the conversion process
  41.              will take place.
  42.  
  43.              If file_name is omitted you go into the interactive mode
  44.              of Easy Data.  The file named DEFAULT.ADB will be loaded
  45.              as the current mask.
  46.  
  47.        The screen will be split in two windows.  The top window is
  48.        Easy Data's main menu.  The bottom window is a description of
  49.        the current conversion mask.(the mask describes the input and
  50.        output files for Easy Data)
  51.  
  52.        To make a menu selection press the number of your choice.  No
  53.        carriage return is needed.
  54.  
  55.        To convert the demo file type:
  56.              CONVDB demo
  57.        The files demo.dbf and demo.ntx will be created.
  58.        The second demo mask should produce an identical data file.
  59.              CONVDB demo2
  60.  
  61. Menu Selections:
  62.  
  63.        1.)   Load Mask
  64.              This selection will prompt you for a mask name.  The name
  65.              can be up to 8 characters long.  The extension .ADB will
  66.              automatically be added to your mask name.
  67.  
  68.              Once a mask is loaded its description will be displayed
  69.              in the lower screen window.
  70.  
  71.        2.)   Edit Mask
  72.              This selection allows you to edit the current mask.  The
  73.              edit keys work the same as read/get in dBASE.
  74.  
  75.              The edit takes place in two separate screens.
  76.              The first screen is the description window already
  77.              displayed on the screen.  Most of these items describe
  78.              the input file.  You must describe the following items
  79.              in this screen.
  80.  
  81.              -Name:       the name for this mask.
  82.              -Desc:       a description of the mask.
  83.              -Input File:       the input file name.
  84.              -Output File:      the output file name.
  85.              -Number of Fields: the number of fields.
  86.              -Field Delimiter:  the way the fields are delimited.
  87.                           0 = no delimiters (ex. DATA01019012DATA)
  88.                           1 = delimiters (ex. "DATA","010190",12,"DATA")
  89.              -Record Delimiter: the way the records are delimited.
  90.                           0 = CR/LF pair.  (most common)
  91.                           1 = CR only
  92.                           2 = LF only
  93.                           3 = no record delimiter
  94.              -Index Expression: the index exp. for the new index file.
  95.                    It must contain a valid index expression.
  96.                    The index will be Clipper format (NTX).
  97.                    If this is left blank no index will be created.
  98.              -Chars. to Ignore: this is for special characters which
  99.                           are in your file which should be ignored.  You
  100.                           can have up to 10 of these characters.  If any
  101.                           of these characters are found in your file they
  102.                           will be converted to spaces when processed.
  103.                             An example would be if your file had $ signs
  104.                           in front of dollar amounts.  In order to place
  105.                           these in a numeric field you need to strip the
  106.                           dollar signs.
  107.        
  108.  
  109.              The second screen contains the field descripters for the
  110.              new dBASE file.  These are standard dBASE field
  111.              descriptions.  You need complete a description for every
  112.              field in the new database file.  
  113.              
  114.              -The following information is required for each field.
  115.                    NAME:        Name of the field (up to 10 characters)
  116.                    TYPE:        Type of field.  C = character
  117.                                                 N = numeric
  118.                                                 D = date
  119.                                                 L = Logical
  120.                    LENGTH:      Length of the field (up to 254).
  121.                    DEC:         Number of decimals in numeric field.
  122.                    
  123.  
  124.        3.)   Save Mask
  125.              This will save the current mask in the default directory. 
  126.              The file name will be the same as the mask name with the
  127.              extension of .ADB.  If a file already exists by that name
  128.              you will be prompted to overwrite (y/n).
  129.  
  130.        4.)   Convert File
  131.              This performs the actual conversion.  The current mask
  132.              file will be used.
  133.  
  134.        0.)   Quit Easy Data and return to a dos prompt.
  135.  
  136.  
  137.  
  138. Now that you know how to use Easy Data and are happy with the
  139. results its time to pay for it.  All I'm ask for is a small
  140. registration fee to cover my time.  This will entitle you to free
  141. upgrades to Easy Data.  
  142.  
  143. To register please send $29.00 to:   John J. Caputo
  144.                                      4830 S. Blvd. N.W.  # 9
  145.                                      Canton, OH 44718
  146. Thank You.
  147.  
  148. You should find Easy Data simple and fast to use.  If you have any
  149. questions or comments please forward them.
  150.  
  151.  
  152.  
  153. Trademark notice:
  154.        dBASE   is a registered trademark of Ashton-Tate.
  155.        Clipper is a registered trademark of Nantucket Corp.
  156.